MacFormat 2000 June

home *** CD-ROM | disk | FTP | other *** search

/ MacFormat 2000 June / macformat-091.iso / Demos / REALbasic 2.1 / REALbasic 2.1 Release Notes < prev next >

Wrap

Text File | 2000-04-17 | 30.2 KB | 650 lines | [TEXT/R*ch]

Release Notes for REALbasic 2.1 April 17, 2000 This release contains the following new features: • (Mac) Icons now exist for RB database files and RB project stationary • (Mac) global function ParseDate(text As String, ByRef parsedDate As Date) As Boolean • (Mac) FolderItem.SaveAsJPEG implemented • (Win32) Application icon added • (Win32) Completely rewrote SelectFolder for Win32. It now calls the standard folder selection dialog instead of the get file dialog. The new interface is much more intuitive. • (Win32) Drag and drop implemented • (Win32) File Drag and Drop implemented on Win32. The Window control's dropEvent is the only one that is currently supported. You can work-around this limitation by obtaining the DropLeft and DropTop coordinates and figuring out which control is being dropped on manually. Note: DropWidth and DropHeight properties have no meaning in Win32 and will return 0 unless set by a REALbasic application using NewDragItem. • (Win32) FolderItem.MoveFileTo implemented • (Win32) Hierarchical list box support added • (Win32) Implementation for contextual menu added • (Win32) Indeterminate progress bars implemented • (Win32) Menu accelerators implemented • (Win32) Movies continue to play in the background when other programs or modal dialogs are in the foreground. • (Win32) Note player implemented, problems on Win NT • (Win32) QuickTime implemented. New features include: MoviePlayer control, Movie Class, FolderItem.OpenAsMovie, FolderItem.CreateMovie, EditableMovie Class, QTTrack class, QTVideoTrack class, QTEffectSequence class, GetQTCrossFadeEffect method, GetQTSMPTEeffect method • (Win32) Sound implemented • (Win32) SpriteSurface implemented • (Win32) Window property: WinHWND As Integer (r) • (Win32) You can pass raw Win32 key codes to GetAsyncKeyDown. Here is how you do it, Add 1 to the raw keyCode and put it in the high word of the integer you are passing. Example: Keyboard.AsyncKeyDown((rawKeyCode + 1) * &hFFFF) Passing Mac Keycodes in the high word is currently identical to passing them in the low word. • About box "Register" button has been moved, and URL now provides visual feedback. • Added REALinRuntime Plugin API call - Returns true if in runtime, false if in IDE • Added Redo Cmd-Key shortcut. (Shift Cmd Z) • Added Region Code selector to the Build Application Dialog. • Build Application... now has a keyboard shortcut (Cmd-M) • Build Progress dialog and threaded build process (Thread Manager is now a pre-requisite of the IDE.) • class QTGraphicsExporter: HasSettingsDialog As Boolean (r), RequestSettings As Boolean, DefaultExtension As String (r), SettingsDescription As String (r), DesiredTargetDataSize As Integer (r/w), CompressionQuality As Integer (r/w), OutputFileType As String (r/w), OutputFileCreator As String (r/w), SavePicture(location As Folder, image As Picture) As Boolean • class QTUserData: UserDataCount(udType As string) As Integer, GetUserData(udType As string, index As Integer, ByRef value As string) As Boolean, AddUserData(udType As string, value As string), RemoveUserData(udType As string, index As Integer), GetUserDataText(udType As string, index As Integer, ByRef value As string, region As Integer) As Boolean, SetUserDataText(udType As string, index As Integer, value As string, region As Integer) • class SoundFormat Properties: Rate As Double (r/w), SampleSize As Integer (r/w), ChannelCount As Integer (r/w), Compression As String (r/w), SamplesPerPacket As Integer (r), BytesPerSample As Integer (r), BytesPerFrame As Integer (r), BytesPerPacket As Integer (r), Methods:, SoundFormat(rate As Double, SampleSize As Integer, ChannelCount As Integer, compression As String) [constructor], SelectSettings As Boolean • Code Editor -- live scrolling enabled for IDE source code editor • compilation constants: Target68k, TargetPPC • Control property: MacControlHandle As Integer • database automatic closing mechanism • Database class method: Close • DatabaseCursorField property: DateValue As Date (r/w) • DatabaseCursorField property: DoubleValue As Double (r/w) • DatabaseCursorField property: JPEGValue As Picture (r/w) • DatabaseCursorField property: MacPictValue As Picture (r/w), IntegerValue As Integer (r/w) • DatabaseRecord properties: DoubleColumn As Double (r/w), IntegerColumn As Integer (r/w), DateColumn As Date (r/w), MacPict As Picture (r/w) • DatabaseRecord property: JPEGColumn(name As String) As Picture • Declare Sub now recognizes short parameter type for 16-bit parameters for 68k • DragItem properties: DropLeft As Integer (r), DropTop As Integer (r), DropWidth As Integer (r), DropHeight As Integer (r) • EditableMovie methods: DataSize(startTime as integer, durationTime As Integer) As Integer • EditableMovie properties: TimeScale As Integer (r/w), TimeValue As Integer (r/w), TimeDuration As Integer (r), UserData As QTUserData (r) • FolderItem properties: MacVRefNum As Integer, MacDirID As Integer • global function: GetTemporaryFolderItem As FolderItem • global method GetQTGraphicsExporter(format as string) As QTGraphicsExporter • List box properties: ColumnAlignment(column As Integer) As Integer (r/w), CellAlignment(row As Integer, cell As Integer) As Integer (r/w), Values for the alignment properties are: 0 = default alignment, 1 = Left Alignment, 2 = Center Alignment, 3 = Right Alignment, 4 = Decimal Alignment (using the internationalized Decimal separator), ColumnAlignmentOffset(column As Integer) As Integer (r/w), CellAlignmentOffset(row As Integer, cell As Integer) As Integer (r/w), The alignment offset properties allow the positioning of the text to be adjusted (+right) • Menus -- Item "Clear" in the menu "Edit" is now enabled for deleting project items. • Movie property: MovieHandle As Integer • MoviePlayer property: QTMovieController As Integer (r) • New RBVersion constant returns the major and minor version number (e.g., 2.1). • New RBVersionString constant returns short RB version string (e.g. "2.1a28"). • Page-up and Page-down implemented in the IDE source editor. • Picture property: Mask As Picture (r) this allows you to access a 256-gray mask that controls the transparency of the picture • Project window -- REALbasic now does much better finding files that have been dragged into the project window when the entire project is moved to another volume. In general it will find any in the same folder or a sub folder as the project. • Project window -- If for some reason REALbasic still can not find items dragged into the project the message in the find dialog is now a bit more descriptive. e.g. If it can't find the picture file 'wonderful' the new message that appears is "Where is the picture called 'wonderful'?" instead of "Where is wonderful?" • PushButton method: Push - Causes the push button to be visually pushed, as well as triggering the Action event • QTTrack methods: DataSize(startTime as integer, durationTime As Integer) As Integer (r) • QTTrack properties: TimeScale As Integer (r/w), TimeDuration As Integer (r), TrackID As Integer (r) • Serial properties: MacInDriverRefNum As Integer (r), MacOutDriverRefNum As Integer (r), Win32DriverHandle As Integer (r) • Sound methods: PlayLooping, Stop • The language popup in the Build Application Dialog is now more informative. The first item 'Default' now shows the name of the default 'Debug' Language in parenthesis following the word Default. e.g. Default (Spanish) • Variables of type "Single" can now be edited in the debugger. (Note that you still can't edit Doubles, however.) • Wait Cursor disable Pragma added a Pragma to disable the automatic display of the wait cursor (or watch cursor). Use #pragma DisableAutoWaitCursor to disable the default behavior. The pragma can be placed anywhere in the code, and it will affect all of your code. • Window property: MacWindowPtr As Integer This release contains the following improvements to previous features: • (Mac) IDE: when a line of code is too complex to compile for 68k, the compiler says so rather than showing an assertion failure. • (Win) Events: AppActivate, AppDeactivate, AppNewDocument, and MDI child window activates and deactivates. Note: event problems still exist. This release contains the following optimizations: • REALbasic applications built with 2.1 are faster than previous versions. Expect a Real World performance increase of 4%, although we have seen speed ups in the 30% range. Test your applications and let us know your mileage. • REALbasic multi-line edit controls are up to 1% faster in benchmarks that stress this control. This release contains the following changes to behavior: • (All) Changed runtime errors to not mention REALbasic or REALbugs to avoid end user confusion. • (DBCS) Changes made to Input Palette behavior on Double Byte systems • (DBCS) Space no longer inserted before dropped double-byte text when using WASTE text engine on double-byte systems. • Online Reference content has been updated • (Win32) Bevel button fixed to use Windows colors properly • (Win32) Built applications now have a Virtual PC compatible creator code and file type. • (Win32) Floating windows implemented • (Win32) Hierarchical lists now have a more standard looking disclosure widget. • (Win32) List box fixed to use Windows colors properly • (Win32) List box now implemented checkbox column type • (Win32) Text Styles -- Error messages are displayed when trying to use unsupported text styles under windows. • About box now reflects more accurate version information. • About box updated to reflect new team members • Binding -- window is now wider. This should allow you to see the binds better. • Build Dialog -- Cancel button removed from Build Progress dialog box (it was redundant anyway) • Build dialog -- the "Version Info" label has been changed to the more accurate "Package Info". • Build Dialog -- new and improved error messages are displayed when the a REALbasic build fails. • Constants -- Edit constant dialog boxes now supports Cut/Copy/Paste for Edit fields • Database -- 4D database driver now returns list of indexes (r) • Database -- 4D database driver extended to support 4D Picture field • Database -- dtF database driver now returns better error messages • Database -- dtF/SQL database driver improvements • Database -- dtF/SQL database driver now returns list of indexes (r) • Find dialog now automatically selects all of the Find string when brought to the front • IDE: Added a Scroll bar to the list box in the Constants dialog • MacWindowPtr property now exported properly • Menus -- New and or different icons have been added to the menus. • ODBC -- LONG VARCHAR/LONG VARBINARY handling improved for ODBC driver • Online Reference now renders read-only properties in bold and content has been updated. • RB database error code for "primary key violation" changed from 2003 to 2005. • Removed the confirmation dialog from the IDE that appears whenever a user attempts to remove a method, property, new event, menu handler, etc. from a window, module, or class. • Saved project files now remember the position of the project window and code editor windows • Slight change to semantics of ListBox.CellAlignmentOffset - now overrides ColumnAlignmentOffset when <> 0, would previously only override when a non-zero CellAlignment was set. • Sound -- Max. number of simultaneous sounds has been increased from 4 to 16. • Strings -- Attempts to create an overly large string from a buffer (e.g., with REALBuildString) now return an empty string, instead of causing the application to quit. • Support having US and Japanese IDE serial # installed on the same machine • The format in which tab panels are stored has been changed, projects with tab panels that have been saved with this version will not display tab panels correctly in older versions. • ThreadID property added to Thread class (for Mac OS & Win32) • Workaround added for bug in Apple's Text Encoding Converter with invalid inputs The following bugs were fixed in this release: • (Mac) Debugger: editing key value during a breakpoint in a KeyDown event no longer causes a crash. • (Mac) IDE: no longer crashes when Undo removes a control while its properties are being edited. • (Mac) Japanese: LTrim, RTrim, and Trim no longer cut certain characters (e.g., "ha"). • (Mac) List box: 68k app no longer crashes when editable list box is clicked. • (Mac) Socket: Calling Socket.LocalAddress on 68k no longer results in a crash. • (Mac) The floating Input Manager palette now works in both the IDE and in built apps. • (Mac) String -- Trying to read a very large file into a string returns an empty string instead of an out of memory error. • (Win) Declare Statement: Works specifically fixes problem with ptr (or memoryblock) within declares. • (Win) FolderItem: OpenAsPicture no longer leaks memory. • (Win) FolderItem: OpenAsPicture will now open file types other than .bmp namely .gif, .jpg, .pic, .png etc. Note: QuickTime must be installed to open these additional types. • (Win) Static text now honors the window background color • (Win) Window.show now forces window to be front most. • (Win) Windows apps no longer crash when you attempt to sort an empty list box (i.e. - clicking in heading). • (Win) Windows custom cursors now have the correct hot-spot. • (Win32) applications now honor window background colors. • (Win32) bevel button fixed for disabled appearance • (Win32) bug with controls on Tab panels fixed • (Win32) bug with modal dialogs still behaving modal when hidden fixed • (Win32) Bug with Win32 printing to page >1 fixed • (Win32) built application icons have much more accurate color, blues and reds are no longer reversed. • (Win32) built application icons no longer constrain the icon to a diamond when the ICN# resource isn't present. • (Win32) CDbl, CStr and Format now use correct separators on foreign language systems • (Win32) Date class properties update correctly • (Win32) Debugging messages removed from Win32 SelectODBCDatabase • (Win32) Default text in Multi-line edit controls now convert line endings properly for Win32 replacing carriage returns with carriage return line feeds. • (Win32) Fixed DrawString with an OpenPrinterDialog so that the coordinates specified in DrawString refer to the baseline and not the upper left corner. • (Win32) Format now handles exponents • (Win32) Graphics.FrameRoundRect and Graphics.FrameOval now uses Graphics.PenWidth instead of 1 • (Win32) Hierarchical list boxes now highlight only the word portion of the each column this behavior is inline with how Windows handles this same issue, see Windows Explorer. • (Win32) If you can compile a Win32 application, you can compile it more than once (without quitting). • (Win32) Inline editable list box fixed • (Win32) Line controls update correctly • (Win32) list box pictures created on the fly, no longer appear in black and white. • (Win32) Mac <--> Win32 color conversions are more accurate. • (Win32) MDI: MouseMove, MouseEnter, and MouseExit events now fire in MDI applications. • (Win32) Movable Modal and Floating Dialog windows no longer cause crashes on Win32 • (Win32) Edit fields now honors colors. There are some circumstances where the edit field will not refresh properly however. Styled edit fields do not honor text color. • (Win32) now supports changing fonts in Edit Fields. • (Win32) now supports keyboard objects. The key codes are mapped directly from the Mac "Extended Keyboard Layout". The following is a list of keys which have mappings which aren't necessarily obvious: Option = Alt, Command = Windows, Help = Insert, Clear = Num Lock, F13 = Print Screen, F14 = Scroll Lock, F15 = Pause. • (Win32) password Edit field controls now work • (Win32) Pictures used in list boxes now appear in Color, the color white is transparent so when the row is highlighted you don't see an ugly border around the picture. • (Win32) QuickTime now idles better then previously allowing other REALbasic components to get processor time. • (Win32) reduced flicker in list box redrawing. • (Win32) SelectODBCDatabase fixed • (Win32) Static text controls now redraw correctly when on top of other controls. • (Win32) string alignment in off screen buffer fixed • (Win32) Styled text printer now works. • (Win32) tab panels no longer require a user refresh before looking their best. • (Win32) Window Frames much more consistent, changes especially evident in MDI environment. Modals: now really modal and can be made re-sizable (GrowIcon) Moveable Modals: now can have close boxes (CloseBox), can be made re-sizable (GrowIcon), and now can have minimize and maximize boxes (ZoomIcon) Global Floating Windows: now float over every other window (except other Global Floaters) and have thin title bars Floating Windows: now float over every window in the application, but not over other windows in other applications. ShadowBoxes: now look distinct from PlainBox. Note: Minimize and maximize boxes require a close box to be present. This is done automatically if you specify (ZoomIcon) Note: Floating Window types can't have Minimize and Maximize Icons. Note: PlainBox and ShadowBox are modal on Win32. Note: MDI document windows must be closable, resizeable, minimizeable, and maximizeable. Note: Since there is nothing remotely similar to a rounded window in Win32 it behaves identically to a Document Window. • 68k Bevel buttons and placards now work in applications. • 68k Boolean arrays now work. • 68k Boolean parameters for Plugin functions are now treated as being 4 bytes long. Boolean return values are safely handled so that they accurately represent the value returned by the plugin function (no corruption occurs.) • 68k bug with Edit field ReadOnly property fixed • 68k bug with Static text font style fixed • 68k code should now be generated correctly, both on 68k and PPC machines. • 68k Declare Sub boolean return parameters fixed • 68k Declare Sub routines now handle return values properly (including short) • A crash in the build dialog (or with use of RGBSurface) on 8.0/8.1 machines has been fixed. • Appearance bevel button replaced • AppleEvent.EnumeratedParam exported properly • Arrays should now always be viewable in the debugger. • Attempting to store values beyond the bounds of a MemoryBlock now raises an OutOfBounds exception, rather than trashing memory contents. • Attempts to allocate a memory block for which there is insufficient memory now returns nil, rather than causing an internal assertion failure. • Balloon help in menu bars no longer leaks memory. (Mac Issue) • Boolean array remove bug fixed • Boolean arrays are now properly displayed in the debugger. • Boolean parameters to plug-ins now work, even when a 68k plugin is called from PPC code. • Build Application Dialog now clears short version, long version, version info, and icon data when a new project is created. • Build Dialog is properly closed when build fails • Build Dialog has a more consistent appearance using themes. • Build Application Dialog language popup in the now remembers last setting between builds. • Built 68k applications no longer crash with LOADSEG failure if they didn't have a list box • Built-in constants now auto-complete, just like other RB keywords. • Code which previously invoked Debugger() now displays an error dialog instead. • Color arrays -- Insert/Append on color arrays fixed • Column name error for RBDB FieldSchema = said "AllowNull" when was really "NotNull" • Compiled applications no longer hijack system memory and sound channels are now allocated only when needed (reduces system memory usage). • Corrected leak resulting from use of mouse cursors. • Crash when calling database.FieldSchema as first call on project database fixed • Crash which could occur when a breakpoint or error occurred while quitting a run in the IDE has been fixed. • Crashing bug in RDBD with accessing LONG VARCHAR fields fixed • Dates now update automagically; no need for "d.totalseconds = d.totalseconds" work-around. • Debugger no longer allows you to tab into uneditable fields (such as Doubles) and thereby to cause a crash. • Declare Sub parameter passing for boolean parameters on 68k fixed • Double-byte intelligent text drag & drop behavior altered. • Failing to return true after Closing a window within its event handler no longer causes a crash. • Fixed a crash which could occur when closing windows under certain circumstances. • Fixed bug where a RBDB database could be opened multiple times concurrently • Fixed bug with 68k declare functions (allocating return space) • Fixed bug with IDE file tracking when project moved • Fixed several bugs relating to constants and languages. • Fixed SQL 'OR' Operator in REAL DB. • Fixes to Database.InsertRecord for external SQL databases for non-string values • FolderItem.Launch extended to support APPC, appe, and cdev • Format() no longer produces a leading comma before three-digit numbers. • GetFolderItem now returns nil when given an invalid path. Note that existing code may need to be updated. • Home and End now work properly in the IDE source editor, and no longer move the insertion point. • IDE -- Bug with remembering position of an open code window fixed • IDE: Bug causing crash upon quitting the IDE after using GetOpenFolder has been fixed. • If the cursor was hidden when a program aborted, it no longer is re-hidden when you restart the program. • IM behavior altered. Should appear on double-byte localized versions of Mac OS more frequently • Lines created or moved at runtime now update properly. • ListBox.CellAlignment and ListBox.CellAlignmentOffset fixed • List boxes now behave correctly when a cell being edited is deleted via RemoveRow or DeleteAllRows. • Local arrays can now again be viewed in the debugger. • Looping sounds no longer leak channels (i.e., hold channels open after they have been stopped). • Looping sounds now have priority over non-looping sounds. • Mac Edit field control now updates immediately if user changes from no password to password mode • Mac Global floating windows now accept drags. • Mac no longer crashes with bad drag data, it just ignores it. • macControlHandle property now works in compiled applications. • Controls are now robust to calling 'close' in an event handler, then failing to return 'true'. • dtF database driver bugs fixed • Movie.looping and .palindrome can now be set at runtime with the desired effect. • Multiple close events are no longer fired when built applications quit. • Nil pictures passed to ExportPicture now raise a NilObjectException, rather than crashing. • Non-appearance disabled bevel buttons no longer fire Action event when clicked • non-Appearance Manager bevel button fixed to support disabled state • Object binding now works in compiled applications. • Occasional crash while sorting a hierarchical List box now fixed. • ODBC driver now supports out-of-order retrieval of column values (This was a limitation in ODBC which the driver now works around) • Online reference rendering glitches fixed • Out-of-memory conditions now display an error message and quit the application, rather than crashing the computer. • Picture Mask memory leak fixed • Picture mask property and DatabaseCursorField.DoubleValue exported properly • Picture.RGBSurface now returns nil for 8-bit pictures, and now works correctly for 16-bit pictures. • Plugin functions are now correctly linked in large projects • Plugin inclusion in built applications works • RBDB ORDER BY sometimes using incorrect sort direction for 2nd or later order columns fixed • Popup menu now raises OutOfBoundsException as required (instead of crashing) • PostgreSQL driver FieldSchema fixed • PostgreSQL driver now recognizes CHAR fields • PostgreSQL memory leak fixed • Project Items such as Menus that would previously print a blank page when attempting to print now print their name. • Project window will no longer be opened off screen. • QuickTime import crashing with QT2.5 installed fixed (usually Mac OS 8 machines) • QuickTime -- QTEffectSequence class no longer returns empty pictures • Quitting RB after changing settings in the 'Build Application' dialog now ask user if they want to save. • Range checking is skipped for size = zero MemoryBlocks returned by m.Ptr. Warning: this allows you to write to arbitrary memory and if used incorrectly, may crash the computer. • RB database no longer crashes when you attempt to store a varchar data longer than the maximum data length (currently 8174 bytes). • RB no longer crashes when killing the debug session if the user has the insertion point in an edit field in the variables window. • RBDB bug with updating incorrect column fixed • RBDB bug with updating multiple columns fixed • RBDB database aggregates fixed • RBDB errors that weren't cleared fixed • RBDB memory leak when opening/closing database fixed • RBDB now properly returns an error on NotNull violations instead of silently failing • RBDB now properly returns an error when inserting a record with an invalid column • REALbasic threads yield more time to other processes & threads • Reduced likelihood of crash when a bevel button or plug-in control is deleted during its own event handler. • Scroll bars now proportional on systems which support that. • SelectFolder now returns nil if the user selected 'Cancel'. • Setting class name equal to the superclass no longer causes a crash. • Setting the password mode in an Edit Field no longer looses the current selection. (Mac and Win32) • Short Declare Sub short return parameters for PowerPC fixed • Single-line edit controls no longer receive duplicate KeyDown events. • Sockets no longer crash when the remote host disappears during a transaction. • Sound IsPlaying property re-enabled • Sounds now stop when a run is terminated and you return to the IDE. • SpriteSurface stopped with the Close method can now be restarted. • SpriteSurface scrolling -- assertion failure while scrolling a was fixed. • Sprite surface with insufficient memory now throws a nilObjectException rather than causing an internal assertion failure. • Sprites now consistently use the world coordinate system. • SpriteSurface is now more robust to errors such as insufficient memory. • SpriteSurface works in the IDE again. • SQLSelect -- Memory leak fixed • Tab panels can now use constants, as can multi-line edit fields and list boxes. • Threads Issues with (stackOverflowExceptions) resolved. • Timers which close their own window no longer cause occasional crashes. • Uppercase, Lowercase, and InStr now work more reliably for two-byte character systems (e.g., Japanese). • Very large numbers no longer crash Format(). • Visible and Enabled properties can now be changed in 68k built applications. • Window and menu names are now validated just like class names. • Window Show/Hide methods now update visible property • Window Show/Hide methods now update visible property in compiled applications • Windows applications no longer abort at startup. • with Enabled property of various controls in 68k IDE fixed Various bug fixes caused these workarounds to fail: • (Win32) Printing on Win32 which compensated for the printing bug by altering the location of the Drawstring y parameter will no longer work properly. • Sprite code that worked around or took advantage of previous buggy behavior will need to be updated. The following known issues still exist in this release • (Win32) global function ParseDate(text As String, ByRef parsedDate As Date) As Boolean crashes. • (Win32) FolderItem.SaveAsJPEG crashes • (Win32) FolderItem.SaveAsPicture crashes • Conflict between Palm Desktop extension and menu items added to Help, on some versions of the Mac OS. • Variables of type "Double" cannot be edited in the debugger. • (Win32) Dragging pictures implemented but still has problems • (Win32) Calling floating point values by reference in Win32 still doesn't work, but now displays a more useful error message, and aborts the build. • (Win32) Runtime explicitly shuts down DirectSound object to fix NT4 bug • (Win32) Styled edit fields do not honor text color. • DatabaseCursorField property: JPEGValue As Picture (r/w) doesn't work. • DatabaseCursorField property: MacPictValue As Picture (r/w), IntegerValue As Integer (r/w) doesn't work. • DatabaseRecord properties: MacPict As Picture (r/w) doesn't work. • DatabaseRecord property: JPEGColumn(name As String) As Picture